home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / cpp_libs / oath.lha / oath / README < prev   
Text File  |  1992-06-08  |  3KB  |  78 lines
  1. //***************************************************************************
  2. //             OATH :: Object-oriented Abstract Type Hierarchy
  3. //***************************************************************************
  4. //
  5. //  Copyright (C) 1991, 1990  Texas Instruments Incorporated
  6. //  Permission is granted to any individual or institution
  7. //  to use, copy, modify, and distribute this software,
  8. //  provided that this complete copyright and permission notice
  9. //  is maintained, intact, in all copies and supporting documentation.
  10. //
  11. //  Texas Instruments Incorporated provides this software "as is"
  12. //  without express or implied warranty.
  13. //
  14. //***************************************************************************
  15.  
  16. Directories
  17. -----------
  18. include/oath -- contains the .h include files
  19. src          -- contains the .cc source files
  20. lib/sun4     -- contains a Makefile to build liboath.a for the sun4 arch
  21. man/man3     -- contains the OATH manual page sources
  22. doc          -- contains documents on OATH (only one currently)
  23. test         -- contains source code for various contrived test files;
  24.         they may be useful for "seeing" some OATH code
  25.  
  26.  
  27. Building OATH
  28. -------------
  29.  
  30. OATH is designed to be compiled with cfront 2.1 compatible compilers.
  31. To compile with cfront 2.0, the source will have to be modified.
  32. At a minimum, all inherited pure virtual functions will have to
  33. be replicated in the derived classes (2.0 did not allow pure virtual
  34. functions to be inherited).  Bugs in 2.0's overloaded function
  35. argument matching can also cause occasional problems.  I have no
  36. idea what will be required to compile with g++.  At a minimum, the
  37. iostream.h include file will be needed.
  38.  
  39.  
  40. Building OATH for a Sun4
  41. ------------------------
  42.  
  43. If you are on a sun4 architecture, and have a C++ compiler named CC,
  44. then simply type 'make' in this directory.
  45. That will simply 'cd lib/sun4; make library',
  46. which will build liboath.a in lib/sun4.
  47. You can then establish a link from wherever to that file (along with
  48. links from wherever to the include files).
  49.  
  50. If your C++ compiler is named other than CC, then simply 
  51. change the line CCC = CC to the name of your compiler
  52. in the lib/sun4/Makefile.
  53.  
  54. The following compiler warnings can be ignored:
  55.     statement not reached
  56.  
  57.  
  58. Building OATH for another architecture
  59. --------------------------------------
  60.  
  61. Make a directory lib/your_arch and place a Makefile in that
  62. directory, using the Makefile in lib/sun4 as a base.
  63. Then type 'make library'.
  64.  
  65. Then establish the appropriate links to lib/your_arch/liboath.a
  66.  
  67.  
  68. Porting Guidlines
  69. -----------------
  70.  
  71. The preprocessor symbol __STDC__ is tested to determine whether a K&R or ANSI
  72. preprocessor is being used to decide whether to use # and ## or the old K&R
  73. way of doing stringization and concatenation.  If you have an old preprocessor,
  74. you probably need do nothing (since __STDC__ should not be defined).  If you
  75. have an ANSI preprocessor, then you may need to use -D__STDC__ in the make if
  76. your preprocessor doesn't define it.
  77.  
  78.